<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="it">
<head>

	<title>Accent 2.0 - Readme</title>

	<!-- FAVICON -->
	<link rel="shortcut icon" type="image/x-icon" href="img/favicon.ico"/>
	
	<!-- STYLE -->
	<link href="../style/index.css" rel="stylesheet" type="text/css" />

    <style type="text/css">
<!--
.box {
	border: thin solid #E5E5E5;
	width: 60%;
	margin: 10px;
	padding: 5px;
	text-align: left;
}
.style1 {color: #0099CC}
.style3 {color: #0099CC; font-weight: bold; }
-->
    </style>
</head>
<body>
<div id="container">
<div id="header">
<div align="center">
<img src="../style/images/header.jpg" alt="header" />
</div>
</div>
<div id="maincontent">
<div align="center">
<h1>Guida Introduttiva</h1>
<div class="box"> 
  <h2 align="center" class="style1" id="0">Benvenuti in Accent 2.0</h2>
  <h3 align="center">    Questa guida vi aiuter&agrave; nell'installazione e nella modifica dell'engine. </h3>
  <ul>
      <li><a href="#1">Requisiti</a></li>
      <li><a href="#2">Installazione</a></li>
      <li><a href="#3">Configurazione</a></li>
      <li><a href="#4">Modifica</a></li>
      <li><a href="#5">Note</a></li>
      <li><a href="#6">Credits</a></li>
  </ul>
    </div>
    <div class="box">
      <h2 align="center" class="style1" id="1">Requisiti</h2>
      <p>Per l'utilizzo dell'engine &egrave; necessario un host che supporti php 5. L'engine utilizza la classe mysqli su mysql 5. Accent &egrave; stato costruito e testato su <a href="http://www.netsons.com/" target="_blank">www.netsons.com</a> e non &egrave; stato riscontrato nessun problema. Non posso assicurare il funzionamento su Altervista o altri host gratuiti che forniscono php e mysql 4.</p>
      <p><span class="style3">Importante:</span> prima dell'installazione &egrave; consigliato creare un database e un utente mysql utilizzando i servizi forniti dal proprio host, associando se possibile l'utente al database.</p>
    <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
    </div>
    <div class="box">
      <h2 align="center" class="style1" id="2">Installazione</h2>
      <p>Per installare l'engine &egrave; stato sviluppato un tool apposito che segue passo passo la configurazione del gdr e la creazione del database. Come prima cosa &egrave; necessario caricare <strong>il contenuto</strong> della cartella <strong>Accent 2.0</strong> sul server web, consiglio di utilizzare un client FTP come <a href="http://filezilla-project.org/" target="_blank">Filezilla</a>. E' necessario mantenere l'esatta struttura delle cartelle. Alla fine dell'upload andate all'indirizzo del vostro sito, se non ci sono stati problemi dovreste visualizzare la pagina di installazione dell'engine.</p>
      <p>Compilate i campi per il database mysql con i dati forniti dal vostro host e proseguite. I passi successivi comprendono la configurazione del GDR e la creazione del file di configurazione <strong>config.inc.php</strong>, posizionato nella cartella inc. Una volta completata la configurazione, verr&agrave; creato il database, o, se presente, verr&agrave; selezionato quello indicato.</p>
      <p>L'ultimo passo &egrave; la creazione dell'account founder, questo grado non pu&ograve; essere assegnato nel gioco e l'unico modo per modificarlo &egrave; da database. L'account founder avr&agrave; accesso agli strumenti per il controllo del database e agli strumenti per visualizzare i logs delle chat.</p>
      <p>Nel caso voleste modificare uno dei valori che avete immesso nella configurazione del gdr, dovrete semplicemente aprire il file <strong>config.inc.php</strong> e modificare da l&igrave; i valori.</p>
      <p><strong class="style1">Importante: </strong>Se ricevete un errore durante la creazione del database, provate a seguire i seguenti passi:<br />
      <ul>
      <li>Andate nella cartella inc/ <strong>sul server</strong>
      e cancellate il file <strong>config.inc.php</strong>.
      <li>Usando gli strumenti del vostro host create un database e un utente. Se possibile associate l'utente al database.
      <li>Tornando all'index del sito verrete reindirizzati di nuovo alla pagina di installazione.
      <li>Inserite i dati mysql, inserendo il nome dell'utente e del database appena creati.
      <li>Completate la configurazione.
      </ul>
      <p>In questo modo la creazione del database non dovrebbe dare problemi. Se ancora lo strumento non funziona dovrete creare manualmente il database: importate il file <strong>accent2.sql</strong>, presente nella cartella install, usando gli strumenti del vostro host, questo creer&agrave; la struttura del database.</p>
      <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
    </div>
    <div class="box">
      <h2 align="center" class="style1" id="3">Configurazione</h2>
      <p>Accent 2.0 fornisce una serie di strumenti per gestire i vari aspetti del gioco. Per accedere a questi strumenti bisogna cliccare nel menu sulla destra, 'Gestione', la voce Amministrazione. Da qui sar&agrave; possibile gestire:</p>
      <ul>
        <li>Bacheche</li>
        <li>Mappe</li>
        <li>Personaggi ( Registrazione, razza, Gilda, Accounts, Ban, Privilegi)</li>
        <li>Chat</li>
        <li>Skills</li>
        <li>News in homepage</li>
        <li>Razze</li>
        <li>Gilde</li>
        <li>Ranghi di gilda</li>
        <li>Oggetti</li>
        <li>Mercato</li>
       </ul>
      <p>Sar&agrave; inoltre possibile visualizzare i logs delle quest e di gioco. Il pacchetto avr&agrave; gi&agrave; dei valori preinseriti, come le locazioni di base o la struttura delle bacheche.</p>
      <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
     </div>
    <div class="box">
      <h2 align="center" class="style1" id="4">Modifica</h2>
      <p>Accent 2.0 si basa su un sistema di templates per separare la parte della programmazione dal layout e dalla grafica, ad ogni pagina php viene assegnata una pagina html, posizionata nella cartella style per comodit&agrave;, che verr&agrave; usata come template. Per passare le variabili dalla pagina php a quella html, la pagina php<strong></strong> invia  un array, con i valori delle variabili e le tag alle quali dovranno essere sostituiti.</p>
      <p>Se per esempio passo una tag chiamata 'temp_name', con valore '<em>tizio</em>' e nell'html c'&egrave; la rispettiva tag &lt;$temp_name$&gt;, questo verr&agrave; sostituito con tizio. Tutte le tag nella pagina html che devono essere sostituite dovranno essere incluse tra '&lt;$' e '$&gt;'. Aggiungere 'temp_' prima del nome della tag &egrave; opzionale, ma aiuta a identificare la tag nell'html.</p>
      <p>Le pagine di amministrazione, di gestione gilda, di strumenti master e di strumenti founder sono tutte inserite nella cartella Admin/ e hanno fogli di stile e templates propri.</p>
      <p><br />
        I fogli di stile, in generale, sono divisi in:</p>
      <p><strong>default.css</strong>: contiene le classi principali, i vari tag e il body.<br />
        <strong>game.css</strong>: contiene il layout della finestra di gioco.<br />
        <strong>general.css</strong>: contiene i div con id specifici e le classi per i messaggi di chat.<br />
      <strong>index.css</strong>: contiene le definizioni per l'homepage.</p>
      <p>Le immagini sono divise in due cartelle:</p>
      <p><strong>style/images/</strong>: contiene le immagini per il layout e pi&ugrave; generalmente quelle che non verranno modificate spesso.<br />
      <strong>img</strong>: viene usata per le immagini delle razze e delle gilde, delle chat, degli avatar e di tutte le immagini che vengono caricate sul server o modificate spesso.</p>
      <p>Sia per le pagine php che per i templates, ho inserito un identificatore all'inizio del nome per dividerle:</p>
      <p><strong>A_</strong>: sono le pagine di amministrazione.<br />
        <strong>F_</strong>: sono le pagine con gli strumenti founder.<br />
            <strong>G_</strong>: sono le pagine dei master di gilda.<br />
                <strong>M_</strong>: sono le pagine dei master fato.<br />
      </p>
      <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
    </div>
        <div class="box">
      <h2 align="center" class="style1" id="5">Note</h2>
      <p>Personalmente, non credo che Accent 2.0 sia il meglio disponibile, n&egrave; che sia programmato perfettamente, in quanto io stesso ho imparato il php man mano che proseguivo con lo sviluppo. Ho passato gli ultimi giorni a ripulire l'engine dai miai obbrobri e a cercare di renderlo perfetto, senza probabilmente riuscirci :).<br />
      Comunque, credo che questo OS potr&agrave; rialzare, anche solo di qualche tacca, il livello attuale del gdr by chat, e spero che qualcuno con buone idee ma scarse capacit&agrave; potr&agrave; usarlo per creare un gdr di buon livello.</p>
      <p>Detto questo, vi lascio con due raccomandazioni.<br />
      Uno: ho speso parecchio tempo per rendere l'engine conforme ai punti del PEL, adattandolo a tutti quelli dove potevo mettere le mani, ora non vi restano che due o tre punti per avere il massimo del punteggio e, sinceramente...quanto ci vuole a mettere un <strong>disclaimer per il copyright</strong> o a <strong>non utilizzare materiale coperto da diritti d'autore</strong>? O a stilare un paio di pagine di <strong>ambientazione e manuale di gioco</strong>? Fate due conti e decidete...</p>
      <p>Due: non parler&ograve; del tempo speso a programmare Accent, perch&egrave; mi &egrave; servito per farmi delle buone basi di php e sarei stato gi&agrave; soddisfatto cos&igrave;. Ma ho deciso di rilasciare il codice per renderlo disponibile alla comunit&agrave;, ci ho lavorato per rifinirlo e adattarlo agli standard OS, e tutto quello che vi chiedo &egrave; di <strong>non usarlo per creare land immodificate</strong> <strong>o fotocopia di altre</strong>, perch&egrave; a rimetterci sareste soltanto voi. <br />
        Come ultima cosa, vi chiedo di <strong>citare i seguenti credits</strong> nel vostro sito.</p>
      <p align="right">	Enjoy.<br />
                <em class="style1"><strong>	Ciupsix</strong></em></p>
      <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
    </div>
    <div class="box">
      <h2 align="center" class="style1" id="6">Credits</h2>
      <p align="center">Accent, v.1.0: <a href="http://www.gdr-online.com/scheda.asp?login=oorazoroo" target="_blank">oorazoroo<br />
      </a>Accent installer, basato sul plugin di: <a href="http://www.gdr-online.com/scheda.asp?login=golars" target="_blank">Golars<br />
      </a>Accent, v.2.0: <a href="http://www.gdr-online.com/scheda.asp?login=ciupsix" target="_blank">Ciupsix<br />
      </a></p>
      <div align="right"><a href="#"><img src="../style/images/up-arrow.jpg" alt="up" width="15" height="17" border="0" /></a></div>
    </div>
</div>
</div>
</body>
</html>